home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-1.iso / Files / System 7 / Frontier / Table.uniqueName.sit / table.uniqueName / DocServer Source Text next >
Encoding:
Text File  |  1992-03-04  |  759 b   |  16 lines  |  [TEXT/ttxt]
  1.  
  2. Verb    table.uniqueName
  3. Syntax    table.uniqueName (prefix, tableAdr)
  4. Parameters    prefix is a string that's used in contructing the unique name.
  5. tableAdr is the address of a table that's about to get a new element.
  6. Action    Iterates over names in the table to return a name that isn't in use.
  7. Returns    An address of an item in the table that doesn't exist, it's safe to assign to.
  8. Examples    table.uniqueName ("item", @scratchpad)
  9.     « scratchpad.item1
  10. table.uniqueName ("item", @scratchpad)^ = 12
  11.     « 12
  12. table.uniqueName ("item", @scratchpad)
  13.     « scratchpad.item2
  14. Notes    Use this verb when you're adding an item to a table that contains several objects of the same type.
  15. An example: you could use this verb to safely add an item to a table of file paths or email accounts.
  16.